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GENERAL DESCRIPTION 


INTERP/MONITOR is a program which farmats and orints tables 
containing Sop frequency and execution times for 931800/81700 
S“machinese The information ts gathered by means of a special 
interpreter which dynamicaily stores it in a table in memory. 
Most B1800/81700 interpreters have the requirec code maintained 
in the source files but conditionally excluded from the object in 
release interpreters. 


RELATED DOCUMENTATION 


Name Number 


Bi800/B1700 Software Operational Guide 1068731 

B1800/B81700 MCPII Pe Se 2212 5462 
B1890/B1700 MCP Control Syntax Pe. Se 2219 O146 
B1800/81700 SDL CBAF Version) Pe Se 2212 5405 


BLi800/B1L700 SOL S-Language 7 Pe. Se 2201 2389 
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SOFTWARE REQUIREMENTS 


INTERP/MONI TOR requires a speciai interpreter which is a standard 
SOL interpreter with the inclusion of a special op which is used 


to ciear the GISMO trace table to zeros in response to. the. 


following user input. 


<job-number>AX CLEAR 


The speciai operator is invoked by INTERP/MCNITOR by using the 
SDL EXECUTE operator. parameters» the number of bits to be 
cleared in the GISMO trace table- is passed to the interpreter 
via the SDL EVALUATION stack. 


Note: SOL/JMONITOR and INTERP/MONITGOR were doth compiled in the 
past and are matched to each other. If one af these is 


recompiteds the other must be recompited alse. Both the 
source and the object of the program are reteased 
internality. However» the source for the interpreter 
should be the most current one avaitable should it need 
to be recompiled. 


The GISMO trace table is used for accumulating the information. 
The interpreter uses the pointer to this table which i135 
maintained tin HINTS. The tabie must be aitocated at CLEAR/START 
by using a debug GISMO (GISMO/DEBUG) and setting the appropriate 
bit to cause the system initializer (SYSTEPM/INIT) to attocate a 


trace table but not request any tracing. The TG SPO command may — 


alse be used to achieve the same resuit. it 18 crucial that 
GISMO and the interpreters do not attempt to use the tabie at the 
same time. Documentation on the GISMO trace table does not exist 
at the time of this writing. 


The tabie is organized as an array of 96 bit entries» with the 
first 48 bits being a time accumulator and the second 48 bits a 
frequency accumulator. 


HARDWARE REQUIREMENTS 


The high resolution timer CHRT) ts a hardware device which» when 


presents is resident in a 8180C/81700 I/0 base or base extension. 
It maintains a 48 bit counter which is updated every 
micro~second. The HRT 8 not required in order to use 
INTERP/MONITOR atthough the program was originaily designed toa 
use information obtained from it. if the HRT is not present» 


INTERP/MONITOR can be used to print out the frequencies of S"OpSe— 
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but ali times wilt be indicatec as zero. (See Appendix A of this 
document for more information on the HRT.) 
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QPERATING INSTRUCTIONS 


INTERP/MONI TOR is executed from the SPO. by the foltowing 
statement. 


EX INTERP/MONITOR 


The program then generates an ACCEPT message to which the user 
should respond: 3 | 


<job-number>AX READ 


INTERP/MONITOR then reads a card fite tabetled CARDS which 
contains the mnemonics associated with the S-machine being 
measured. Each mnemonic must be on a separate card and the 
mnemonics must be in ascending Sop order. For example, for SOL>» 
successive cards would be as follows: | 


LA 
ILA 
sT00 
LITN 
LIT 
etc. 


Each mnemonic may be a maximum of six characters» may begin 
anywhere on the card» and may contain any EBCDIC character except 


a olank»~ If» after reading the entire card file» INTERP/MONITOR 


determines that there is insufficient space in the GISMO trace 
table to accommodate the specified numder of mnemonicse the 
orogram witt request the user to CLEAR/START and provide’ the 
values to enter in the console switches to insure sufficient 
space. | 


If sufficient space is available» the user may then execute his 
pregram using the special interpreter which enters values into 
the table. 
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COMMANDS 

This section contains a description of the command set of 
INTERP/MONITOR. Commands are entered by issuing ACCEPTS to the 
program. , 
ANALYZE-TAPE»SINGLE 
 ANALYZE.TAPE 
Sy¥fitak: “-<<.-c° ANALYZE.~TAPE.SINGLE -- <print variant> --7>1 
a aaa ANALYZE.TAPE “- <print variant> ---77777->] 


(See the PRINT command for a description of <print variant>. 
See the DUMP.TO.~TAPE and CLOSE commands for information on 
how the tape is generated.) 


INTERP/MONITOR can analyze a tape in one of two ways. If the 
command entered is ANALYZE.TAPE.~SINGLE>» the program prints a 
table for each separate table on the tape. lf the command is 


ANALYZE.TAPE»  adl of the files are analyzed and the information 
merged into one tabie. 


If the command ts ANALYZE.TAPE then after colilecting all of the 
information from each tape» INTERP/MONITOR witt ask if more tares 
are to be accumulated. A user response of "Y*" will cause 
INTERP/MONITOR to read another tape. A user response of "N” will 
cause INTERP/MONITOR to print cut the accumulated tables in the 


requested formats. The totads in this table are a simple 
accumulations there is no attempt to weigh the various tables 
accumulated. 
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CLEAR 
Syntaxs  stetrrrorerses CLEAR samt r retest tts ssersscreecccnro | 


This command clears the entire GISMO trace table to zeros. 
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 «SLOSE 


Syntax: 2 eee ee CLOSE Boe ore fee ln ge ee Ere am anm - a mo >4 


After the DUMP.TO.TAPE commanc has teen used to dump tabdtes to a 


tapes this command is used to close and rewind the tape. 


ie cara a 
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QUMPsTO2 TAPE 


Syntax? oem DUMP ATOLTAPE wert ttt ttt e rr se ster atari 


This command causes the current contents of the GISMG trace table 
to be dumped to tape. Any number of tables may be dumped to one 
tape since the tape remains open and not rewound after the table 


is dumped. The tape file may te closed and rewound by entering 


the CLOSE command. 


eee 
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PARAMS - 
ba | _3 | : : 
Syntax? sotsscot= PARAMS soe7-" SPO cn-=- wn mewn ener rennet 


Pee > CARDS =o>1 


This option provides the user with the ability to enter 
: parameters from the card reader or the SPC. (See the PRINT 
BL | command.) If they are entered trom the card readers column one cf 

| the card must contain an 1+ aT» or an 0 to indicate which 
parameter is on the card. Gniy one of each is permitted. The. 
actual text must begin in column ec. 


The abbreviations indicate the following: 
I “= INTERPRETER .NAME 


T wm TITLE 
O “~~ TIMER.OQVERHEAD 


Example of input from cards: 


ISDL/TIMERINT 
TSOL/COMPILER OF MCP ON SYS 805 
06 
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PRINI 


Syntax: Sere (PRIN See eee COL Vit: Vat lant >. -<So >= ea Oe 


At any time» the user may enter a print command to request that 
the current contents of the tattle be printed. INTERP/ MONITOR 
makes a copy of the trace table within itself using one S-op toa 
move the values from the GISMO trace table» thereby insuring that 
no user program can change the values in the table while they are 
being printed. | 


The table can be printed in any combination of four formats. Tt 


may be ordered by Sop» time» frequency » or printed 
alphabetically. When the table is orderec by time or frequency» 
zero entries may be suppressed by inctuding the SUPPRESS option. 
The ALL variant wiil print four tables» one each by timer 


frequency» Sop and atphabetical. 


Ali possible print variants are shown in the syntax below. 


<OF URL Naf tanto 2924 2ese Se seen ees te eva ee eee aaa al >1 

i-- BY ->1 1 
Ct rer en settee tosses n- 1 

fer TIME seen neo eono->] 

jo= TIMES. Seer erte sees) ) 

t= FREQUENCY: eee Pree >I 

fo. FREQUENCIES “=s3=2 ->1 

i~= FREQ so+esnaeas--->] 

Le> PF REGS rer esa lees 

Im-- ALPHABETIC ------ a> | 

i-~ ALPHABETICAL w----->1 

be ALPHA smear nenn nnn ->] 


fm" SLOP stern ne nnen=->t 


a= S.OPS toceenn nn n--->1 


}-- SUPPRESS ---------->1 
ba= SUP teen een en en e--->] 


I-- ALL woeernn- wacaen->} 


The user 15 requested to enter the eon now ing information to de 
used in printing the table. 


INTERPRETER.NAME 


The first 21 characters witl be used te 
identify the name of the interpreter that 


9s being measurede — 


He 
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TITLE | The title enterec will be included in the 
: output of the table. It may ce up to 80 


characters in tength. 


The user calculates the time required in 
the interpreter to turn the timer off and 


on between each S~0p. The vaiue entered: 


will be printed on the Listing. 


The parameters specified above may be entered from the card 


reader 
section.) 


Note: 


For debugging purposes,» if the leftmost bit of the | 
console switches is on» INTERP/MONITCR will not request. 
the above information. Blanks will be assumed for 
INTERPRETERs»NAME and TLITLE and zero for TIMER-OVERHEAD. 
(See MCP manual for use of the SPO "SE" command.) 


This decimal number will be subtracted _ 
from the time associated with each Sop. 


if the PARAMS option is used. (See PARAMS In this 
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len 
ond 
co 
me) 


Syntax: a i aceite car aad STOP eee ee ewe meen awe mae nen wnnn nm amaamn> | 


This command terminates INTERP/MONITOR. 
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PPENDIX A = HIGH RESOLUTLON TIMER 


This appendix describ2s a 81800/B1706 é diduirk didete Cat wer ee” 


connected : to the [/0 Exchange (a standard channel) and provide a 
reat time clock function. A number of variants are describded 


which controt the counter attributes and actions. The modute | 


wiil occupies Greco eeren card. 


The counter may be read using conventional 1/0 Suchen commands 
_fros the processor. 


The counter can be operated as one 48 bit device or as four 12 


bit devices in order to test overflow logic. It can atsc be 
preset to a number using conventtonal I/0 Exchange commands. 


Counter overflows will not triacger a service request» but can be 


detected through a TEST STATUS command. 


OPERATIONS 


The descriptions of the following operations use terminology 
applicable to the 81800/81700 [7/70 8uUS. | : 

le INITIAL COUNT D-SET INTO COUNTER: 

Counter is O-Set to a number by reading 24 bits during each of 


two RC times. This §s done with a TRANSFER OUT B command. 


2e READ THE COUNTER: 


Before a new counts the 48 bits are latched and can be read into 


the processor. with two RC*S without stopping the counter. The. 
D-Set condition of the tatches is stopped during the time the 


count 1s being read into the processor. Adl these are done witn 


a TRANSFER IN. Note -~ TRANSFER OUT to a counter does not start. 


the counters nor does TRANSFER IN stop the counter. 
3. OTHER FUNCTIONS: | 


Ae TEST: On a normat test» the unit will return status as 
well as normal 1[.0. | ee 


0 for counting up 
1 for counting down 


—EX08 
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EXO9 = 0 for no overflow/uncerflow in lowest order 
12 bit counter. since last D-Set 
= 1 for overfilow/underflow occurred in lowest 
order 12 bit counter after tast D-Set 
EXx10 = 0 Csame as EX09» for second 12 bit counter). 
= 1 (same as EX0%» for second 12 bit counter) 
EX1i1 = 0 (same as EX0%s for third 12 bit counter) 
: = 1 C€same as EX09>» for third 12 bit counter) 
EX1i2 = 9 (same as EX09» for highest order 12 bit counter) 
| = 1 (same as EX09» for highest order 12 bit counter) 
EX13 = 1 for four 12 tit counter configuration | 
oo | 3 9 for 48-bit counter configuration 
EXL6-EX1L9 = 9001 for counter stopped | 


2010 for counter counting 


Be. TEST & CLEAR 


Same as above but also clears all togic including counter outputs 
to zero. A clear command stops the counter and sets it ina 4A 
bite countingtup configuratior as well as resetting the overflow 
flip-flops. The status reported during RC time will oe Enat: cof 
the counter immediately before the clear. 


C. OPTIONS 


A TRANSFER_OUT_A operation may be used to set ootions in the HRT. 


At CA timer a variant indicates one of the nena operations: — 


EXOO“EX02 = 000 - start ‘counting 
001 = stop counting 
910 = count up 
011 7 count down 
100 - counter structured as one 48 bit counter 
101 = counter structured as four 12 dit ccunters 


Curing RC time» TRANSFER_OUT_A returns status and 12D.» as during > 
RC time of a TEST command. In XFRIN and XFROTS commandss 48 o1its 
of data are always transferred. Therefores two RC times will 

always follow the CA time of either of these two commands. 
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EUNCTIONS ‘IN DETAIL 
1. READ COUNT INTO COUNTER: 


At CA timer if the channel address is equal» the TRANSFER QUT 
PHASE B instruction bits are strobed into the 3-bit register and 


decoded. The command register will not be cleared until the end 
of the second RC time. Note that there exists an F/F.» RCIF.s to 


differentiate the two RC*s. With the first RC» the first 24 bits 
are D-Set into the lower part of the counter and with second RC» 
ancther 24 bits are D-Set into the uppper-half of the counter. 


2e READ THE COUNT QUT: 


The xXFRIN command is decoded and the D-Set Mode of the latch is 
stopped. The contents of the latch are read by two RC*'sS with 24 
bits each time onto the exchange lines» the tower order 24 dits 
being enabled onto the exchange Lines before the higher order 
bits. 7 —— 


Note: The TRANSFER 3UT A command is being used primarily tc set. 


the configuration of the counter (Ceither 1x48 bits or 
&4xi2 bits) and to stop and start it counting either uo or 
down. The TEST STATUS and TEST AND CLEAR commands are 
used to determine the counter'"s status. 


GENERAL COMMENTS ON 81700 HIGH SPEED TIMER MODULE 


It is anticipated that the Timer Module will be an “add on" 


device and wiadl not be present on att Bi700%s. As suche its use. 


will be confined to special runs and in some cases specialized 


software available "in house”. Thus» for the timer portion af 
the MODULE» one 48-bit counter running at a I1MHzZ rate 1s_ 
sufficient. If additional counting functions are desireds then 


the one hardware counter can te programaticatly “gated” inta one 
or more memory buckets to provide the needed capabilities. 


From a diagnostic point of views the hardware %s capable of 
breaking the counter into 4712 bit counters» disconnecting the 
overflow tLogic between these counters» but allowing the driving 1 
MHZ signal to be programmatically moved to the low order position 
of each of the 12 bit counters. In this waye each of the 12 bit 
sections can be individually tested» inclucing its overflows in a 
short period of times In the 12 bit configurations the overflow 


from each counter will set the overflow flip-flops> but will not. 


feed into the next higher 12 bit counter. 


Notes 


An% 
BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1800/B1700 INTERP/MONITOR | 
SBP: IN-PLANT USE ONLY : T.P.S. 2219 9334 — 


This timer modute may only be used with MCP*s of Mark. 


Level 4.1 or Later and must be on Channel 15. The device 
1.0. for the module is 100C00 (binary) which was chosen 


to insure that even if the MCP sees the device» it will 
ignore it since it dooks like a datacomm [.D-~ | However» 
this. should never occur because GISM0O reports “MISSING 
DEVICE" for all inquiries on Channet 15. | 
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